home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / src / cmds / addhost / RCS / addhost.man,v < prev   
Encoding:
Text File  |  1990-02-13  |  7.0 KB  |  246 lines
  1. head     1.4;
  2. branch   ;
  3. access   ;
  4. symbols  ;
  5. locks    ; strict;
  6. comment  @@;
  7.  
  8.  
  9. 1.4
  10. date     90.02.13.15.40.57;  author jhh;  state Exp;
  11. branches ;
  12. next     1.3;
  13.  
  14. 1.3
  15. date     90.01.21.19.46.52;  author jhh;  state Exp;
  16. branches ;
  17. next     1.2;
  18.  
  19. 1.2
  20. date     90.01.18.17.42.40;  author jhh;  state Exp;
  21. branches ;
  22. next     1.1;
  23.  
  24. 1.1
  25. date     90.01.16.13.20.59;  author jhh;  state Exp;
  26. branches ;
  27. next     ;
  28.  
  29.  
  30. desc
  31. @original version
  32. @
  33.  
  34.  
  35. 1.4
  36. log
  37. @updated
  38. @
  39. text
  40. @'\" Copyright 1989 Regents of the University of California
  41. '\" Permission to use, copy, modify, and distribute this
  42. '\" documentation for any purpose and without fee is hereby
  43. '\" granted, provided that this notice appears in all copies.
  44. '\" The University of California makes no representations about
  45. '\" the suitability of this material for any purpose.  It is
  46. '\" provided "as is" without express or implied warranty.
  47. '\" 
  48. '\" $Header: /sprite/src/cmds/addhost/RCS/addhost.man,v 1.3 90/01/21 19:46:52 jhh Exp $ SPRITE (Berkeley)
  49. '/" 
  50. .so \*(]ltmac.sprite
  51. .HS ADDHOST cmds
  52. .BS
  53. '\" Note:  do not modify the .SH NAME line immediately below!
  54. .SH NAME
  55. addhost \- Add a new host to the system
  56. .SH SYNOPSIS
  57. \fBaddhost\fR [\fIoptions\fR] [\fB\-n \fIname\fR \fB\-i \fIinternet\fR \fB\-a \fInetAddress\fR \fB\-m \fImachineType\fR \fB\-s\fR \fIswapDir\fR]
  58. .SH OPTIONS
  59.  
  60. .IP "\fB\-a \fIaddress\fR" 15
  61. The \fB\-a\fR flag is required, and is used to set the local network
  62. address of the host.
  63. Usually \fIaddress\fR is an Ethernet address, and is of the form
  64. "a:b:c:d:e:f".
  65.  
  66. .IP "\fB\-d \fIdomain\fR" 15
  67. Used to set the local domain.  
  68. The \fIdomain\fR string is appended to the name provided by the \fB\-n\fR
  69. flag to produce the full name of the machine.
  70. The default is to parse the domain name from the \fIspritehosts\fR file.
  71. If the file is empty then the \fB\-d\fR flag must be given.
  72.  
  73. .IP "\fB\-h\fR, \fB\-help\fR, \fB\-?\fR" 15
  74. These options cause a help listing to be printed.
  75.  
  76. .IP "\fB\-i \fIinternet\fR" 15
  77. \fIInternet\fR is the internet address of the host. 
  78. The address is in the form "a.b.c.d".
  79. This flag is required.
  80.  
  81. .IP "\fB\-I \fIspriteID\fR" 15
  82. The \fB\-I\fR flag is used to assign a Sprite ID to the host.
  83. Care must be taken that \fIspriteID\fR does not conflict with the id
  84. of an existing host.
  85. If the \fB\-I\fR flag is omitted \fBaddhost\fR will use a Sprite ID
  86. that is one greater than the largest id found in the \fIspritehosts\fR file.
  87.  
  88. .IP "\fB\-m \fImachineType\fR" 15
  89. This flag sets the machine type of the host to be added. 
  90. This flag must be used.
  91. Supported machine types are \fIsun3\fR, \fIsun4\fR, \fIsun4c\fR, and 
  92. \fIds3100\fR.
  93.  
  94. .IP "\fB\-n \fIname\fR" 15
  95. \fIName\fR is the name of the host. 
  96. This flag is required.
  97.  
  98. .IP "\fB\-s \fIswapDir\fR" 15
  99. The \fB\-s\fR defines \fIswapDir\fR to be the directory in which to 
  100. create the swap directory for the new host.
  101. The default is /swap.
  102. If a different directory is specified then a link will be make in /swap.
  103.  
  104. .IP "\fB\-t \fInetType\fR" 15
  105. The \fB\-t\fR flag is used to set the type of the network associated with
  106. the host.
  107. The default is \fIether\fR, indicating that the host is connected to the
  108. system via an Ethernet, and the the argument to the \fB\-a\fR flag is 
  109. the Ethernet address of the host.
  110. The only other supported value for the \fInetType\fR argument
  111. is \fIinet\fR,
  112. indicating that a gateway exists between the host and the root file server.
  113. In this case the argument to the \fB\-a\fR flag is the Ethernet address
  114. of the gateway machine.
  115.  
  116. .IP "\fB\-R\fR" 15
  117. \fBAddhost\fR will not allow a host to be added if the name of the
  118. new host conflicts with the name of an existing host.
  119. If the \fB\-R\fR flag is specified than the existing host information
  120. is replaced with the information for the new host.
  121. If you are upgrading a machine from one machine type to another but
  122. retaining the name then the \fB\-R\fR flag should be used.
  123.  
  124. .IP "\fB\-r \fIroot\fR" 15
  125. The \fB\-r\fR flag is used to specify that the root of the Sprite
  126. filesystem is something other than "/".  
  127. .BE
  128.  
  129. .IP "\fB\-o \fIowner\fR" 15
  130. Used to specify the owner or primary user of the machine.
  131. This information is added to /sprite/admin/hosts.
  132.  
  133. .IP "\fB\-l \fIlocation\fR" 15
  134. Used to specify the location of the machine.
  135. This information is added to /sprite/admin/hosts.
  136.  
  137. .IP "\fB\-T \fImachine description\fR" 15
  138. The \fB\-T\fR
  139. flag is used to specify the full machine description.
  140. Examples might be "sun3/75" or "sun4/260".
  141. This information is added to /sprite/admin/hosts.
  142.  
  143.  
  144.  
  145. .SH DESCRIPTION
  146. .PP
  147. The \fBaddhost\fR command is used to add a new host to the system.
  148. It should only be run by the super-user (root).
  149. Invoking \fBaddhost\fR without any options will cause it to run in
  150. an interactive mode where you will be prompted for the host name,
  151. type, etc.
  152. These parameters can also be set via options on the command line.
  153. The use of any options causes \fBaddhost\fR to not run interactively.
  154. In this case a minimum set of options must be used.
  155. The \fB\-a\fR, \fB\-i\fR, \fB\-n\fR, \fB\-m\fR, and \fB\-s\fR flags
  156. must be used to
  157. indicate the local address, Internet address, host name, host machine
  158. type, and swap directory, respectively.
  159. The options are described in more detail in the section above.
  160. .PP
  161. As the \fBaddhost\fR script runs it will print out information on the actions
  162. it is taking.
  163. Once the script is complete you should look in /sprite/admin/howto/addNewHost
  164. for any remaining steps in the installation procedure.
  165.  
  166. .SH FILES
  167. The following files are edited by \fBaddhost\fR:
  168. /etc/spritehosts, /etc/hosts.equiv, /sprite/admin/hosts
  169.  
  170. .SH KEYWORDS
  171. spritehosts, new, host, hosts, hosts.equiv
  172.  
  173. @
  174.  
  175.  
  176. 1.3
  177. log
  178. @fixed keywords section
  179. @
  180. text
  181. @d9 1
  182. a9 1
  183. '\" $Header: /sprite/src/cmds/addhost/RCS/addhost.man,v 1.2 90/01/18 17:42:40 jhh Exp Locker: jhh $ SPRITE (Berkeley)
  184. d77 11
  185. a87 5
  186. .IP "\fB\-u \fIroot\fR" 15
  187. If the \fB\-u\fR flag must be given if the script is run on a Unix system.
  188. It is assumed that the Sprite root disk is mounted somewhere other than as 
  189. "/", hence the need for the \fIroot\fR argument.  \fIRoot\fR is the 
  190. prefix leading to the Sprite root.
  191. d90 16
  192. d116 1
  193. a116 1
  194. The \fB\-a\fR, \fB\-i\fR, \fB\-n\fR, and \fB\-m\fR flags
  195. d119 1
  196. a119 1
  197. type, respectively.
  198. a120 4
  199. The \fIaddhost\fR script assumes that the name given with the \fB\-n\fR
  200. flag is new.
  201. \fBAddhost\fR will not work correctly if the name is a reuse of an old name,
  202. as might happen if equipment is upgraded and the name is retained.
  203. d126 5
  204. d132 1
  205. a132 1
  206. spritehosts, new, host
  207. @
  208.  
  209.  
  210. 1.2
  211. log
  212. @New! Improved! Interactive!
  213. @
  214. text
  215. @d9 1
  216. a9 1
  217. '\" $Header: /sprite/src/cmds/addhost/RCS/addhost.man,v 1.1 90/01/16 13:20:59 jhh Exp $ SPRITE (Berkeley)
  218. d109 1
  219. a109 1
  220. spritehosts, hosts, 
  221. @
  222.  
  223.  
  224. 1.1
  225. log
  226. @Initial revision
  227. @
  228. text
  229. @d9 1
  230. a9 1
  231. '\" $Header: /sprite/lib/forms/RCS/cmd.man,v 1.1 89/02/23 13:08:24 ouster Exp $ SPRITE (Berkeley)
  232. d18 1
  233. a18 1
  234. \fBaddhost\fR [\fIoptions\fR] \fB\-n \fIname\fR \fB\-i \fIinternet\fR \fB\-a \fInetAddress\fR \fB\-m \fImachineType\fR \fB\-s\fR \fIswapDir\fR
  235. d62 2
  236. a63 2
  237. A symbolic link will be made to the swap directory in /swap.
  238. This flag is required.
  239. d88 7
  240. a94 1
  241. The \fB\-a\fR, \fB\-i\fR, \fB\-n\fR, \fB\-m\fR, and \fB\-s\fR flags
  242. d97 1
  243. a97 1
  244. type, and swap directory, respectively.
  245. @
  246.